"""
@Create Time     : 2025/4/11 11:49
@Description     : 时间处理工具类
"""

from datetime import datetime


class TimeUtils:
    """
    时间处理工具类，包含常用的时间格式转换方法

    属性：
        timezone: 时区设置，默认为系统时区
    """

    @staticmethod
    def get_current_date() -> str:
        """
        获取当前日期（YYYY-MM-DD格式）
        示例：2023-08-15
        """
        return datetime.now().strftime("%Y-%m-%d")

    @classmethod
    def get_full_datetime(cls, with_ms=False) -> str:
        """
        获取完整日期时间
        :param with_ms: 是否包含毫秒
        示例：2023-08-15 14:30:45 或 2023-08-15 14:30:45.500
        """
        fmt = "%Y-%m-%d %H:%M:%S.%f" if with_ms else "%Y-%m-%d %H:%M:%S"
        return (
            datetime.now().strftime(fmt)[:-3]
            if with_ms
            else datetime.now().strftime(fmt)
        )
